home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2003 August / MW 8 2003 CD1.iso / Inside Macworld / Product News / gimp-1.2.4.sit / gimp-1.2.4 / devel-docs / libgimp / sgml / gimpwidgets.sgml < prev    next >
Encoding:
Text File  |  2003-05-20  |  63.0 KB  |  1,203 lines
  1. <refentry id="libgimp-gimpwidgets" revision="19 Jan 2001">
  2. <refmeta>
  3. <refentrytitle>gimpwidgets</refentrytitle>
  4. <manvolnum>3</manvolnum>
  5. <refmiscinfo>LIBGIMP Library</refmiscinfo>
  6. </refmeta>
  7.  
  8. <refnamediv>
  9. <refname>gimpwidgets</refname><refpurpose>A collection of convenient widget constructors, standard callbacks and
  10. helper functions.</refpurpose>
  11. </refnamediv>
  12.  
  13. <refsynopsisdiv><title>Synopsis</title>
  14. <synopsis>
  15.  
  16.  
  17.  
  18. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-option-menu-new">gimp_option_menu_new</link>            (<link linkend="gboolean">gboolean</link> menu_only,
  19.                                              ...);
  20. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-option-menu-new2">gimp_option_menu_new2</link>           (<link linkend="gboolean">gboolean</link> menu_only,
  21.                                              <link linkend="GtkSignalFunc">GtkSignalFunc</link> menu_item_callback,
  22.                                              <link linkend="gpointer">gpointer</link> data,
  23.                                              <link linkend="gpointer">gpointer</link> initial,
  24.                                              ...);
  25. void        <link linkend="gimp-option-menu-set-history">gimp_option_menu_set_history</link>    (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
  26.                                              <link linkend="gpointer">gpointer</link> user_data);
  27. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-radio-group-new">gimp_radio_group_new</link>            (<link linkend="gboolean">gboolean</link> in_frame,
  28.                                              const <link linkend="gchar">gchar</link> *frame_title,
  29.                                              ...);
  30. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-radio-group-new2">gimp_radio_group_new2</link>           (<link linkend="gboolean">gboolean</link> in_frame,
  31.                                              const <link linkend="gchar">gchar</link> *frame_title,
  32.                                              <link linkend="GtkSignalFunc">GtkSignalFunc</link> radio_button_callback,
  33.                                              <link linkend="gpointer">gpointer</link> data,
  34.                                              <link linkend="gpointer">gpointer</link> initial,
  35.                                              ...);
  36. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-spin-button-new">gimp_spin_button_new</link>            (<link linkend="GtkObject">GtkObject</link> **adjustment,
  37.                                              <link linkend="gfloat">gfloat</link> value,
  38.                                              <link linkend="gfloat">gfloat</link> lower,
  39.                                              <link linkend="gfloat">gfloat</link> upper,
  40.                                              <link linkend="gfloat">gfloat</link> step_increment,
  41.                                              <link linkend="gfloat">gfloat</link> page_increment,
  42.                                              <link linkend="gfloat">gfloat</link> page_size,
  43.                                              <link linkend="gfloat">gfloat</link> climb_rate,
  44.                                              <link linkend="guint">guint</link> digits);
  45. <link linkend="GtkObject">GtkObject</link>*  <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>            (<link linkend="GtkTable">GtkTable</link> *table,
  46.                                              <link linkend="gint">gint</link> column,
  47.                                              <link linkend="gint">gint</link> row,
  48.                                              const <link linkend="gchar">gchar</link> *text,
  49.                                              <link linkend="gint">gint</link> scale_usize,
  50.                                              <link linkend="gint">gint</link> spinbutton_usize,
  51.                                              <link linkend="gfloat">gfloat</link> value,
  52.                                              <link linkend="gfloat">gfloat</link> lower,
  53.                                              <link linkend="gfloat">gfloat</link> upper,
  54.                                              <link linkend="gfloat">gfloat</link> step_increment,
  55.                                              <link linkend="gfloat">gfloat</link> page_increment,
  56.                                              <link linkend="guint">guint</link> digits,
  57.                                              <link linkend="gboolean">gboolean</link> constrain,
  58.                                              <link linkend="gfloat">gfloat</link> unconstrained_lower,
  59.                                              <link linkend="gfloat">gfloat</link> unconstrained_upper,
  60.                                              const <link linkend="gchar">gchar</link> *tooltip,
  61.                                              const <link linkend="gchar">gchar</link> *help_data);
  62. #define     <link linkend="GIMP-SCALE-ENTRY-LABEL-CAPS">GIMP_SCALE_ENTRY_LABEL</link>          (adj)
  63. #define     <link linkend="GIMP-SCALE-ENTRY-SCALE-CAPS">GIMP_SCALE_ENTRY_SCALE</link>          (adj)
  64. #define     <link linkend="GIMP-SCALE-ENTRY-SCALE-ADJ-CAPS">GIMP_SCALE_ENTRY_SCALE_ADJ</link>      (adj)
  65. #define     <link linkend="GIMP-SCALE-ENTRY-SPINBUTTON-CAPS">GIMP_SCALE_ENTRY_SPINBUTTON</link>     (adj)
  66. #define     <link linkend="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ-CAPS">GIMP_SCALE_ENTRY_SPINBUTTON_ADJ</link> (adj)
  67. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-random-seed-new">gimp_random_seed_new</link>            (<link linkend="gint">gint</link> *seed,
  68.                                              <link linkend="gint">gint</link> *use_time,
  69.                                              <link linkend="gint">gint</link> time_true,
  70.                                              <link linkend="gint">gint</link> time_false);
  71. #define     <link linkend="GIMP-RANDOM-SEED-SPINBUTTON-CAPS">GIMP_RANDOM_SEED_SPINBUTTON</link>     (hbox)
  72. #define     <link linkend="GIMP-RANDOM-SEED-SPINBUTTON-ADJ-CAPS">GIMP_RANDOM_SEED_SPINBUTTON_ADJ</link> (hbox)
  73. #define     <link linkend="GIMP-RANDOM-SEED-TOGGLEBUTTON-CAPS">GIMP_RANDOM_SEED_TOGGLEBUTTON</link>   (hbox)
  74. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-coordinates-new">gimp_coordinates_new</link>            (<link linkend="GimpUnit">GimpUnit</link> unit,
  75.                                              const <link linkend="gchar">gchar</link> *unit_format,
  76.                                              <link linkend="gboolean">gboolean</link> menu_show_pixels,
  77.                                              <link linkend="gboolean">gboolean</link> menu_show_percent,
  78.                                              <link linkend="gint">gint</link> spinbutton_usize,
  79.                                              <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy,
  80.                                              <link linkend="gboolean">gboolean</link> chainbutton_active,
  81.                                              <link linkend="gboolean">gboolean</link> chain_constrains_ratio,
  82.                                              const <link linkend="gchar">gchar</link> *xlabel,
  83.                                              <link linkend="gdouble">gdouble</link> x,
  84.                                              <link linkend="gdouble">gdouble</link> xres,
  85.                                              <link linkend="gdouble">gdouble</link> lower_boundary_x,
  86.                                              <link linkend="gdouble">gdouble</link> upper_boundary_x,
  87.                                              <link linkend="gdouble">gdouble</link> xsize_0,
  88.                                              <link linkend="gdouble">gdouble</link> xsize_100,
  89.                                              const <link linkend="gchar">gchar</link> *ylabel,
  90.                                              <link linkend="gdouble">gdouble</link> y,
  91.                                              <link linkend="gdouble">gdouble</link> yres,
  92.                                              <link linkend="gdouble">gdouble</link> lower_boundary_y,
  93.                                              <link linkend="gdouble">gdouble</link> upper_boundary_y,
  94.                                              <link linkend="gdouble">gdouble</link> ysize_0,
  95.                                              <link linkend="gdouble">gdouble</link> ysize_100);
  96. #define     <link linkend="GIMP-COORDINATES-CHAINBUTTON-CAPS">GIMP_COORDINATES_CHAINBUTTON</link>    (sizeentry)
  97. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-mem-size-entry-new">gimp_mem_size_entry_new</link>         (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);
  98. #define     <link linkend="GIMP-MEM-SIZE-ENTRY-SPINBUTTON-CAPS">GIMP_MEM_SIZE_ENTRY_SPINBUTTON</link>  (memsize)
  99. #define     <link linkend="GIMP-MEM-SIZE-ENTRY-SPINBUTTON-ADJ-CAPS">GIMP_MEM_SIZE_ENTRY_SPINBUTTON_ADJ</link>(memsize)
  100. #define     <link linkend="GIMP-MEM-SIZE-ENTRY-OPTIONMENU-CAPS">GIMP_MEM_SIZE_ENTRY_OPTIONMENU</link>  (memsize)
  101. <link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gimp-pixmap-button-new">gimp_pixmap_button_new</link>          (<link linkend="gchar">gchar</link> **xpm_data,
  102.                                              const <link linkend="gchar">gchar</link> *text);
  103. void        <link linkend="gimp-toggle-button-sensitive-update">gimp_toggle_button_sensitive_update</link>
  104.                                             (<link linkend="GtkToggleButton">GtkToggleButton</link> *toggle_button);
  105. void        <link linkend="gimp-toggle-button-update">gimp_toggle_button_update</link>       (<link linkend="GtkWidget">GtkWidget</link> *widget,
  106.                                              <link linkend="gpointer">gpointer</link> data);
  107. void        <link linkend="gimp-radio-button-update">gimp_radio_button_update</link>        (<link linkend="GtkWidget">GtkWidget</link> *widget,
  108.                                              <link linkend="gpointer">gpointer</link> data);
  109. void        <link linkend="gimp-menu-item-update">gimp_menu_item_update</link>           (<link linkend="GtkWidget">GtkWidget</link> *widget,
  110.                                              <link linkend="gpointer">gpointer</link> data);
  111. void        <link linkend="gimp-int-adjustment-update">gimp_int_adjustment_update</link>      (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  112.                                              <link linkend="gpointer">gpointer</link> data);
  113. void        <link linkend="gimp-uint-adjustment-update">gimp_uint_adjustment_update</link>     (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  114.                                              <link linkend="gpointer">gpointer</link> data);
  115. void        <link linkend="gimp-float-adjustment-update">gimp_float_adjustment_update</link>    (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  116.                                              <link linkend="gpointer">gpointer</link> data);
  117. void        <link linkend="gimp-double-adjustment-update">gimp_double_adjustment_update</link>   (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  118.                                              <link linkend="gpointer">gpointer</link> data);
  119. void        <link linkend="gimp-unit-menu-update">gimp_unit_menu_update</link>           (<link linkend="GtkWidget">GtkWidget</link> *widget,
  120.                                              <link linkend="gpointer">gpointer</link> data);
  121. void        <link linkend="gimp-table-attach-aligned">gimp_table_attach_aligned</link>       (<link linkend="GtkTable">GtkTable</link> *table,
  122.                                              <link linkend="gint">gint</link> column,
  123.                                              <link linkend="gint">gint</link> row,
  124.                                              const <link linkend="gchar">gchar</link> *label_text,
  125.                                              <link linkend="gfloat">gfloat</link> xalign,
  126.                                              <link linkend="gfloat">gfloat</link> yalign,
  127.                                              <link linkend="GtkWidget">GtkWidget</link> *widget,
  128.                                              <link linkend="gint">gint</link> colspan,
  129.                                              <link linkend="gboolean">gboolean</link> left_align);
  130. </synopsis>
  131. </refsynopsisdiv>
  132.  
  133.  
  134.  
  135.  
  136.  
  137. <refsect1>
  138. <title>Description</title>
  139. <para>
  140.  
  141. </para>
  142. </refsect1>
  143.  
  144. <refsect1>
  145. <title>Details</title>
  146. <refsect2>
  147. <title><anchor id="gimp-option-menu-new">gimp_option_menu_new ()</title>
  148. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_option_menu_new            (<link linkend="gboolean">gboolean</link> menu_only,
  149.                                              ...);</programlisting>
  150. <para>
  151. </para>
  152. <para>
  153.  
  154. The <parameter>va_list</parameter> describing the <link linkend="GtkMenuItem">GtkMenuItem</link>'s has the following format:
  155.  
  156. <informaltable pgwide=1 frame="none" role="struct">
  157. <tgroup cols="2"><colspec colwidth="4*"><colspec colwidth="8*">
  158. <tbody>
  159.  
  160. <row>
  161. <entry><link linkend="gchar">gchar</link> *label,</entry>
  162. <entry>The menu item's label.</entry>
  163. </row>
  164.  
  165. <row>
  166. <entry><link linkend="GtkSignalFunc">GtkSignalFunc</link> callback,</entry>
  167. <entry>The callback which will be connected to the menu item's
  168. "activate" signal</entry>
  169. </row>
  170.  
  171. <row>
  172. <entry><link linkend="gpointer">gpointer</link> data,</entry>
  173. <entry>The callback data which will be used in <link linkend="gtk-signal-connect">gtk_signal_connect</link>().</entry>
  174. </row>
  175.  
  176. <row>
  177. <entry><link linkend="gpointer">gpointer</link> user_data,</entry>
  178. <entry>The menu item's <parameter>user_data</parameter> which will be set with
  179. <link linkend="gtk-object-set-user-data">gtk_object_set_user_data</link>().</entry>
  180. </row>
  181.  
  182. <row>
  183. <entry><link linkend="GtkWidget">GtkWidget</link> **widget_ptr,</entry>
  184. <entry>A pointer to store the created menu item in.</entry>
  185. </row>
  186.  
  187. <row>
  188. <entry><link linkend="gboolean">gboolean</link> active,</entry>
  189. <entry><link linkend="TRUE-CAPS">TRUE</link> if this should be the initially selected menu item.</entry>
  190. </row>
  191.  
  192. </tbody></tgroup></informaltable>
  193.  
  194. </para><informaltable pgwide=1 frame="none" role="params">
  195. <tgroup cols="2">
  196. <colspec colwidth="2*">
  197. <colspec colwidth="8*">
  198. <tbody>
  199. <row><entry align="right"><parameter>menu_only</parameter> :</entry>
  200. <entry> <link linkend="TRUE-CAPS">TRUE</link> if the function should return a <link linkend="GtkMenu">GtkMenu</link> only.
  201. </entry></row>
  202. <row><entry align="right"><parameter>...</parameter> :</entry>
  203. <entry>       A <link linkend="NULL-CAPS">NULL</link> terminated <parameter>va_list</parameter> describing the menu items.
  204. </entry></row>
  205. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkOptionMenu">GtkOptionMenu</link> or a <link linkend="GtkMenu">GtkMenu</link> (depending on <parameter>menu_only</parameter>).
  206. </entry></row>
  207. </tbody></tgroup></informaltable></refsect2>
  208. <refsect2>
  209. <title><anchor id="gimp-option-menu-new2">gimp_option_menu_new2 ()</title>
  210. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_option_menu_new2           (<link linkend="gboolean">gboolean</link> menu_only,
  211.                                              <link linkend="GtkSignalFunc">GtkSignalFunc</link> menu_item_callback,
  212.                                              <link linkend="gpointer">gpointer</link> data,
  213.                                              <link linkend="gpointer">gpointer</link> initial,
  214.                                              ...);</programlisting>
  215. <para>
  216. </para>
  217. <para>
  218.  
  219. The <parameter>va_list</parameter> describing the <link linkend="GtkMenuItem">GtkMenuItem</link>'s has the following format:
  220.  
  221. <informaltable pgwide=1 frame="none" role="struct">
  222. <tgroup cols="2"><colspec colwidth="4*"><colspec colwidth="8*">
  223. <tbody>
  224.  
  225. <row>
  226. <entry><link linkend="gchar">gchar</link> *label,</entry>
  227. <entry>The menu item's label.</entry>
  228. </row>
  229.  
  230. <row>
  231. <entry><link linkend="gpointer">gpointer</link> user_data,</entry>
  232. <entry>The menu item's <parameter>user_data</parameter> which will be set with
  233. <link linkend="gtk-object-set-user-data">gtk_object_set_user_data</link>().</entry>
  234. </row>
  235.  
  236. <row>
  237. <entry><link linkend="GtkWidget">GtkWidget</link> **widget_ptr,</entry>
  238. <entry>A pointer to store the created menu item in.</entry>
  239. </row>
  240.  
  241. </tbody></tgroup></informaltable>
  242.  
  243. </para><informaltable pgwide=1 frame="none" role="params">
  244. <tgroup cols="2">
  245. <colspec colwidth="2*">
  246. <colspec colwidth="8*">
  247. <tbody>
  248. <row><entry align="right"><parameter>menu_only</parameter> :</entry>
  249. <entry>          <link linkend="TRUE-CAPS">TRUE</link> if the function should return a <link linkend="GtkMenu">GtkMenu</link> only.
  250. </entry></row>
  251. <row><entry align="right"><parameter>menu_item_callback</parameter> :</entry>
  252. <entry> The callback each menu item's "activate" signal will
  253. be connected with.
  254. </entry></row>
  255. <row><entry align="right"><parameter>data</parameter> :</entry>
  256. <entry>               The data which will be passed to <link linkend="gtk-signal-connect">gtk_signal_connect</link>().
  257. </entry></row>
  258. <row><entry align="right"><parameter>initial</parameter> :</entry>
  259. <entry>            The <parameter>user_data</parameter> of the initially selected menu item.
  260. </entry></row>
  261. <row><entry align="right"><parameter>...</parameter> :</entry>
  262. <entry>                A <link linkend="NULL-CAPS">NULL</link> terminated <parameter>va_list</parameter> describing the menu items.
  263. </entry></row>
  264. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkOptionMenu">GtkOptionMenu</link> or a <link linkend="GtkMenu">GtkMenu</link> (depending on <parameter>menu_only</parameter>).
  265. </entry></row>
  266. </tbody></tgroup></informaltable></refsect2>
  267. <refsect2>
  268. <title><anchor id="gimp-option-menu-set-history">gimp_option_menu_set_history ()</title>
  269. <programlisting>void        gimp_option_menu_set_history    (<link linkend="GtkOptionMenu">GtkOptionMenu</link> *option_menu,
  270.                                              <link linkend="gpointer">gpointer</link> user_data);</programlisting>
  271. <para>
  272. </para>
  273. <para>
  274.  
  275. </para><informaltable pgwide=1 frame="none" role="params">
  276. <tgroup cols="2">
  277. <colspec colwidth="2*">
  278. <colspec colwidth="8*">
  279. <tbody>
  280. <row><entry align="right"><parameter>option_menu</parameter> :</entry>
  281. <entry> A <link linkend="GtkOptionMenu">GtkOptionMenu</link> as returned by <link linkend="gimp-option-menu-new">gimp_option_menu_new</link>() or
  282. <link linkend="gimp-option-menu-new2">gimp_option_menu_new2</link>().
  283. </entry></row>
  284. <row><entry align="right"><parameter>user_data</parameter> :</entry>
  285. <entry>   The <parameter>user_data</parameter> of the menu item you want to select.
  286. </entry></row>
  287. </tbody></tgroup></informaltable></refsect2>
  288. <refsect2>
  289. <title><anchor id="gimp-radio-group-new">gimp_radio_group_new ()</title>
  290. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_radio_group_new            (<link linkend="gboolean">gboolean</link> in_frame,
  291.                                              const <link linkend="gchar">gchar</link> *frame_title,
  292.                                              ...);</programlisting>
  293. <para>
  294. </para>
  295. <para>
  296.  
  297. The <parameter>va_list</parameter> describing the <link linkend="GtkRadioButton">GtkRadioButton</link>'s has the following format:
  298.  
  299. <informaltable pgwide=1 frame="none" role="struct">
  300. <tgroup cols="2"><colspec colwidth="4*"><colspec colwidth="8*">
  301. <tbody>
  302.  
  303. <row>
  304. <entry><link linkend="gchar">gchar</link> *label,</entry>
  305. <entry>The radio button's label.</entry>
  306. </row>
  307.  
  308. <row>
  309. <entry><link linkend="GtkSignalFunc">GtkSignalFunc</link> callback,</entry>
  310. <entry>The callback which will be connected to the radio button's
  311. "toggled" signal</entry>
  312. </row>
  313.  
  314. <row>
  315. <entry><link linkend="gpointer">gpointer</link> data,</entry>
  316. <entry>The callback data which will be used in <link linkend="gtk-signal-connect">gtk_signal_connect</link>().</entry>
  317. </row>
  318.  
  319. <row>
  320. <entry><link linkend="gpointer">gpointer</link> user_data,</entry>
  321. <entry>The radio button's <parameter>user_data</parameter> which will be set with
  322. <link linkend="gtk-object-set-user-data">gtk_object_set_user_data</link>().</entry>
  323. </row>
  324.  
  325. <row>
  326. <entry><link linkend="GtkWidget">GtkWidget</link> **widget_ptr,</entry>
  327. <entry>A pointer to store the created radio button in.</entry>
  328. </row>
  329.  
  330. <row>
  331. <entry><link linkend="gboolean">gboolean</link> active,</entry>
  332. <entry><link linkend="TRUE-CAPS">TRUE</link> if this should be the initially pressed radio button.</entry>
  333. </row>
  334.  
  335. </tbody></tgroup></informaltable>
  336.  
  337. </para><informaltable pgwide=1 frame="none" role="params">
  338. <tgroup cols="2">
  339. <colspec colwidth="2*">
  340. <colspec colwidth="8*">
  341. <tbody>
  342. <row><entry align="right"><parameter>in_frame</parameter> :</entry>
  343. <entry>    <link linkend="TRUE-CAPS">TRUE</link> if you want a <link linkend="GtkFrame">GtkFrame</link> around the radio button group.
  344. </entry></row>
  345. <row><entry align="right"><parameter>frame_title</parameter> :</entry>
  346. <entry> The title of the Frame or <link linkend="NULL-CAPS">NULL</link> if you don't want a title.
  347. </entry></row>
  348. <row><entry align="right"><parameter>...</parameter> :</entry>
  349. <entry>         A <link linkend="NULL-CAPS">NULL</link> terminated <parameter>va_list</parameter> describing the radio buttons.
  350. </entry></row>
  351. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkFrame">GtkFrame</link> or <link linkend="GtkVbox">GtkVbox</link> (depending on <parameter>in_frame</parameter>).
  352. </entry></row>
  353. </tbody></tgroup></informaltable></refsect2>
  354. <refsect2>
  355. <title><anchor id="gimp-radio-group-new2">gimp_radio_group_new2 ()</title>
  356. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_radio_group_new2           (<link linkend="gboolean">gboolean</link> in_frame,
  357.                                              const <link linkend="gchar">gchar</link> *frame_title,
  358.                                              <link linkend="GtkSignalFunc">GtkSignalFunc</link> radio_button_callback,
  359.                                              <link linkend="gpointer">gpointer</link> data,
  360.                                              <link linkend="gpointer">gpointer</link> initial,
  361.                                              ...);</programlisting>
  362. <para>
  363. </para>
  364. <para>
  365.  
  366. The <parameter>va_list</parameter> describing the <link linkend="GtkRadioButton">GtkRadioButton</link>'s has the following format:
  367.  
  368. <informaltable pgwide=1 frame="none" role="struct">
  369. <tgroup cols="2"><colspec colwidth="4*"><colspec colwidth="8*">
  370. <tbody>
  371.  
  372. <row>
  373. <entry><link linkend="gchar">gchar</link> *label,</entry>
  374. <entry>The radio button's label.</entry>
  375. </row>
  376.  
  377. <row>
  378. <entry><link linkend="gpointer">gpointer</link> user_data,</entry>
  379. <entry>The radio button's <parameter>user_data</parameter> which will be set with
  380. <link linkend="gtk-object-set-user-data">gtk_object_set_user_data</link>().</entry>
  381. </row>
  382.  
  383. <row>
  384. <entry><link linkend="GtkWidget">GtkWidget</link> **widget_ptr,</entry>
  385. <entry>A pointer to store the created radio button in.</entry>
  386. </row>
  387.  
  388. </tbody></tgroup></informaltable>
  389.  
  390. </para><informaltable pgwide=1 frame="none" role="params">
  391. <tgroup cols="2">
  392. <colspec colwidth="2*">
  393. <colspec colwidth="8*">
  394. <tbody>
  395. <row><entry align="right"><parameter>in_frame</parameter> :</entry>
  396. <entry>              <link linkend="TRUE-CAPS">TRUE</link> if you want a <link linkend="GtkFrame">GtkFrame</link> around the
  397. radio button group.
  398. </entry></row>
  399. <row><entry align="right"><parameter>frame_title</parameter> :</entry>
  400. <entry>           The title of the Frame or <link linkend="NULL-CAPS">NULL</link> if you don't want
  401. a title.
  402. </entry></row>
  403. <row><entry align="right"><parameter>radio_button_callback</parameter> :</entry>
  404. <entry> The callback each button's "toggled" signal will
  405. be connected with.
  406. </entry></row>
  407. <row><entry align="right"><parameter>data</parameter> :</entry>
  408. <entry>                  The data which will be passed to
  409. <link linkend="gtk-signal-connect">gtk_signal_connect</link>().
  410. </entry></row>
  411. <row><entry align="right"><parameter>initial</parameter> :</entry>
  412. <entry>               The <parameter>user_data</parameter> of the initially pressed radio button.
  413. </entry></row>
  414. <row><entry align="right"><parameter>...</parameter> :</entry>
  415. <entry>                   A <link linkend="NULL-CAPS">NULL</link> terminated <parameter>va_list</parameter> describing
  416. the radio buttons.
  417. </entry></row>
  418. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkFrame">GtkFrame</link> or <link linkend="GtkVbox">GtkVbox</link> (depending on <parameter>in_frame</parameter>).
  419. </entry></row>
  420. </tbody></tgroup></informaltable></refsect2>
  421. <refsect2>
  422. <title><anchor id="gimp-spin-button-new">gimp_spin_button_new ()</title>
  423. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_spin_button_new            (<link linkend="GtkObject">GtkObject</link> **adjustment,
  424.                                              <link linkend="gfloat">gfloat</link> value,
  425.                                              <link linkend="gfloat">gfloat</link> lower,
  426.                                              <link linkend="gfloat">gfloat</link> upper,
  427.                                              <link linkend="gfloat">gfloat</link> step_increment,
  428.                                              <link linkend="gfloat">gfloat</link> page_increment,
  429.                                              <link linkend="gfloat">gfloat</link> page_size,
  430.                                              <link linkend="gfloat">gfloat</link> climb_rate,
  431.                                              <link linkend="guint">guint</link> digits);</programlisting>
  432. <para>
  433. This function is a shortcut for <link linkend="gtk-adjustment-new">gtk_adjustment_new</link>() and a subsequent
  434. <link linkend="gtk-spin-button-new">gtk_spin_button_new</link>() and does some more initialisation stuff like
  435. setting a standard minimun horizontal size.</para>
  436. <para>
  437.  
  438. </para><informaltable pgwide=1 frame="none" role="params">
  439. <tgroup cols="2">
  440. <colspec colwidth="2*">
  441. <colspec colwidth="8*">
  442. <tbody>
  443. <row><entry align="right"><parameter>adjustment</parameter> :</entry>
  444. <entry>     Returns the spinbutton's <link linkend="GtkAdjustment">GtkAdjustment</link>.
  445. </entry></row>
  446. <row><entry align="right"><parameter>value</parameter> :</entry>
  447. <entry>          The initial value of the spinbutton.
  448. </entry></row>
  449. <row><entry align="right"><parameter>lower</parameter> :</entry>
  450. <entry>          The lower boundary.
  451. </entry></row>
  452. <row><entry align="right"><parameter>upper</parameter> :</entry>
  453. <entry>          The uppper boundary.
  454. </entry></row>
  455. <row><entry align="right"><parameter>step_increment</parameter> :</entry>
  456. <entry> The spinbutton's step increment.
  457. </entry></row>
  458. <row><entry align="right"><parameter>page_increment</parameter> :</entry>
  459. <entry> The spinbutton's page increment (mouse button 2).
  460. </entry></row>
  461. <row><entry align="right"><parameter>page_size</parameter> :</entry>
  462. <entry>      The spinbutton's page size.
  463. </entry></row>
  464. <row><entry align="right"><parameter>climb_rate</parameter> :</entry>
  465. <entry>     The spinbutton's climb rate.
  466. </entry></row>
  467. <row><entry align="right"><parameter>digits</parameter> :</entry>
  468. <entry>         The spinbutton's number of decimal digits.
  469. </entry></row>
  470. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkSpinbutton">GtkSpinbutton</link> and it's <link linkend="GtkAdjustment">GtkAdjustment</link>.
  471. </entry></row>
  472. </tbody></tgroup></informaltable></refsect2>
  473. <refsect2>
  474. <title><anchor id="gimp-scale-entry-new">gimp_scale_entry_new ()</title>
  475. <programlisting><link linkend="GtkObject">GtkObject</link>*  gimp_scale_entry_new            (<link linkend="GtkTable">GtkTable</link> *table,
  476.                                              <link linkend="gint">gint</link> column,
  477.                                              <link linkend="gint">gint</link> row,
  478.                                              const <link linkend="gchar">gchar</link> *text,
  479.                                              <link linkend="gint">gint</link> scale_usize,
  480.                                              <link linkend="gint">gint</link> spinbutton_usize,
  481.                                              <link linkend="gfloat">gfloat</link> value,
  482.                                              <link linkend="gfloat">gfloat</link> lower,
  483.                                              <link linkend="gfloat">gfloat</link> upper,
  484.                                              <link linkend="gfloat">gfloat</link> step_increment,
  485.                                              <link linkend="gfloat">gfloat</link> page_increment,
  486.                                              <link linkend="guint">guint</link> digits,
  487.                                              <link linkend="gboolean">gboolean</link> constrain,
  488.                                              <link linkend="gfloat">gfloat</link> unconstrained_lower,
  489.                                              <link linkend="gfloat">gfloat</link> unconstrained_upper,
  490.                                              const <link linkend="gchar">gchar</link> *tooltip,
  491.                                              const <link linkend="gchar">gchar</link> *help_data);</programlisting>
  492. <para>
  493. This function creates a <link linkend="GtkLabel">GtkLabel</link>, a <link linkend="GtkHScale">GtkHScale</link> and a <link linkend="GtkSpinButton">GtkSpinButton</link> and
  494. attaches them to a 3-column <link linkend="GtkTable">GtkTable</link>.
  495. </para>
  496. <para>
  497. Note that if you pass a <parameter>tooltip</parameter> or <parameter>help_data</parameter> to this function you'll
  498. have to initialize GIMP's help system with <link linkend="gimp-help-init">gimp_help_init</link>() before using it.</para>
  499. <para>
  500.  
  501. </para><informaltable pgwide=1 frame="none" role="params">
  502. <tgroup cols="2">
  503. <colspec colwidth="2*">
  504. <colspec colwidth="8*">
  505. <tbody>
  506. <row><entry align="right"><parameter>table</parameter> :</entry>
  507. <entry>               The <link linkend="GtkTable">GtkTable</link> the widgets will be attached to.
  508. </entry></row>
  509. <row><entry align="right"><parameter>column</parameter> :</entry>
  510. <entry>              The column to start with.
  511. </entry></row>
  512. <row><entry align="right"><parameter>row</parameter> :</entry>
  513. <entry>                 The row to attach the widgets.
  514. </entry></row>
  515. <row><entry align="right"><parameter>text</parameter> :</entry>
  516. <entry>                The text for the <link linkend="GtkLabel">GtkLabel</link> which will appear
  517. left of the <link linkend="GtkHScale">GtkHScale</link>.
  518. </entry></row>
  519. <row><entry align="right"><parameter>scale_usize</parameter> :</entry>
  520. <entry>         The minimum horizontal size of the <link linkend="GtkHScale">GtkHScale</link>.
  521. </entry></row>
  522. <row><entry align="right"><parameter>spinbutton_usize</parameter> :</entry>
  523. <entry>    The minimum horizontal size of the <link linkend="GtkSpinButton">GtkSpinButton</link>.
  524. </entry></row>
  525. <row><entry align="right"><parameter>value</parameter> :</entry>
  526. <entry>               The initial value.
  527. </entry></row>
  528. <row><entry align="right"><parameter>lower</parameter> :</entry>
  529. <entry>               The lower boundary.
  530. </entry></row>
  531. <row><entry align="right"><parameter>upper</parameter> :</entry>
  532. <entry>               The upper boundary.
  533. </entry></row>
  534. <row><entry align="right"><parameter>step_increment</parameter> :</entry>
  535. <entry>      The step increment.
  536. </entry></row>
  537. <row><entry align="right"><parameter>page_increment</parameter> :</entry>
  538. <entry>      The page increment.
  539. </entry></row>
  540. <row><entry align="right"><parameter>digits</parameter> :</entry>
  541. <entry>              The number of decimal digits.
  542. </entry></row>
  543. <row><entry align="right"><parameter>constrain</parameter> :</entry>
  544. <entry>           <link linkend="TRUE-CAPS">TRUE</link> if the range of possible values of the
  545. <link linkend="GtkSpinButton">GtkSpinButton</link> should be the same as of the <link linkend="GtkHScale">GtkHScale</link>.
  546. </entry></row>
  547. <row><entry align="right"><parameter>unconstrained_lower</parameter> :</entry>
  548. <entry> The spinbutton's lower boundary
  549. if <parameter>constrain</parameter> == <link linkend="FALSE-CAPS">FALSE</link>.
  550. </entry></row>
  551. <row><entry align="right"><parameter>unconstrained_upper</parameter> :</entry>
  552. <entry> The spinbutton's upper boundary
  553. if <parameter>constrain</parameter> == <link linkend="FALSE-CAPS">FALSE</link>.
  554. </entry></row>
  555. <row><entry align="right"><parameter>tooltip</parameter> :</entry>
  556. <entry>             A tooltip message for the scale and the spinbutton.
  557. </entry></row>
  558. <row><entry align="right"><parameter>help_data</parameter> :</entry>
  559. <entry>           The widgets' help_data (see <link linkend="gimp-help-set-help-data">gimp_help_set_help_data</link>()).
  560. </entry></row>
  561. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The <link linkend="GtkSpinButton">GtkSpinButton</link>'s <link linkend="GtkAdjustment">GtkAdjustment</link>.
  562. </entry></row>
  563. </tbody></tgroup></informaltable></refsect2>
  564. <refsect2>
  565. <title><anchor id="GIMP-SCALE-ENTRY-LABEL-CAPS">GIMP_SCALE_ENTRY_LABEL()</title>
  566. <programlisting>#define     GIMP_SCALE_ENTRY_LABEL(adj)</programlisting>
  567. <para>
  568. Returns the scale_entry's <link linkend="GtkLabel">GtkLabel</link>.
  569. </para><informaltable pgwide=1 frame="none" role="params">
  570. <tgroup cols="2">
  571. <colspec colwidth="2*">
  572. <colspec colwidth="8*">
  573. <tbody>
  574. <row><entry align="right"><parameter>adj</parameter> :</entry>
  575. <entry>The <link linkend="GtkAdjustment">GtkAdjustment</link> returned by <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>().
  576.  
  577.  
  578. </entry></row>
  579. </tbody></tgroup></informaltable></refsect2>
  580. <refsect2>
  581. <title><anchor id="GIMP-SCALE-ENTRY-SCALE-CAPS">GIMP_SCALE_ENTRY_SCALE()</title>
  582. <programlisting>#define     GIMP_SCALE_ENTRY_SCALE(adj)</programlisting>
  583. <para>
  584. Returns the scale_entry's <link linkend="GtkHScale">GtkHScale</link>.
  585. </para><informaltable pgwide=1 frame="none" role="params">
  586. <tgroup cols="2">
  587. <colspec colwidth="2*">
  588. <colspec colwidth="8*">
  589. <tbody>
  590. <row><entry align="right"><parameter>adj</parameter> :</entry>
  591. <entry>The <link linkend="GtkAdjustment">GtkAdjustment</link> returned by <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>().
  592.  
  593.  
  594. </entry></row>
  595. </tbody></tgroup></informaltable></refsect2>
  596. <refsect2>
  597. <title><anchor id="GIMP-SCALE-ENTRY-SCALE-ADJ-CAPS">GIMP_SCALE_ENTRY_SCALE_ADJ()</title>
  598. <programlisting>#define     GIMP_SCALE_ENTRY_SCALE_ADJ(adj)</programlisting>
  599. <para>
  600. Returns the <link linkend="GtkAdjustment">GtkAdjustment</link> of the scale_entry's <link linkend="GtkHScale">GtkHScale</link>.
  601. </para><informaltable pgwide=1 frame="none" role="params">
  602. <tgroup cols="2">
  603. <colspec colwidth="2*">
  604. <colspec colwidth="8*">
  605. <tbody>
  606. <row><entry align="right"><parameter>adj</parameter> :</entry>
  607. <entry>The <link linkend="GtkAdjustment">GtkAdjustment</link> returned by <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>().
  608.  
  609.  
  610. </entry></row>
  611. </tbody></tgroup></informaltable></refsect2>
  612. <refsect2>
  613. <title><anchor id="GIMP-SCALE-ENTRY-SPINBUTTON-CAPS">GIMP_SCALE_ENTRY_SPINBUTTON()</title>
  614. <programlisting>#define     GIMP_SCALE_ENTRY_SPINBUTTON(adj)</programlisting>
  615. <para>
  616. Returns the scale_entry's <link linkend="GtkSpinButton">GtkSpinButton</link>.
  617. </para><informaltable pgwide=1 frame="none" role="params">
  618. <tgroup cols="2">
  619. <colspec colwidth="2*">
  620. <colspec colwidth="8*">
  621. <tbody>
  622. <row><entry align="right"><parameter>adj</parameter> :</entry>
  623. <entry>The <link linkend="GtkAdjustment">GtkAdjustment</link> returned by <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>().
  624.  
  625.  
  626. </entry></row>
  627. </tbody></tgroup></informaltable></refsect2>
  628. <refsect2>
  629. <title><anchor id="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ-CAPS">GIMP_SCALE_ENTRY_SPINBUTTON_ADJ()</title>
  630. <programlisting>#define     GIMP_SCALE_ENTRY_SPINBUTTON_ADJ(adj)</programlisting>
  631. <para>
  632. Returns the <link linkend="GtkAdjustment">GtkAdjustment</link> of the scale_entry's <link linkend="GtkSpinButton">GtkSpinButton</link>.
  633. </para><informaltable pgwide=1 frame="none" role="params">
  634. <tgroup cols="2">
  635. <colspec colwidth="2*">
  636. <colspec colwidth="8*">
  637. <tbody>
  638. <row><entry align="right"><parameter>adj</parameter> :</entry>
  639. <entry>The <link linkend="GtkAdjustment">GtkAdjustment</link> returned by <link linkend="gimp-scale-entry-new">gimp_scale_entry_new</link>().
  640.  
  641.  
  642. </entry></row>
  643. </tbody></tgroup></informaltable></refsect2>
  644. <refsect2>
  645. <title><anchor id="gimp-random-seed-new">gimp_random_seed_new ()</title>
  646. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_random_seed_new            (<link linkend="gint">gint</link> *seed,
  647.                                              <link linkend="gint">gint</link> *use_time,
  648.                                              <link linkend="gint">gint</link> time_true,
  649.                                              <link linkend="gint">gint</link> time_false);</programlisting>
  650. <para>
  651. Note that this widget automatically sets tooltips with
  652. <link linkend="gimp-help-set-help-data">gimp_help_set_help_data</link>(), so you'll have to initialize GIMP's help
  653. system with <link linkend="gimp-help-init">gimp_help_init</link>() before using it.</para>
  654. <para>
  655.  
  656. </para><informaltable pgwide=1 frame="none" role="params">
  657. <tgroup cols="2">
  658. <colspec colwidth="2*">
  659. <colspec colwidth="8*">
  660. <tbody>
  661. <row><entry align="right"><parameter>seed</parameter> :</entry>
  662. <entry>       A pointer to the variable which stores the random seed.
  663. </entry></row>
  664. <row><entry align="right"><parameter>use_time</parameter> :</entry>
  665. <entry>   A pointer to the variable which stores the <parameter>use_time</parameter>
  666. toggle boolean.
  667. </entry></row>
  668. <row><entry align="right"><parameter>time_true</parameter> :</entry>
  669. <entry>  The value to write to <parameter>use_time</parameter> if the toggle button is checked.
  670. </entry></row>
  671. <row><entry align="right"><parameter>time_false</parameter> :</entry>
  672. <entry> The value to write to <parameter>use_time</parameter> if the toggle button is
  673. unchecked.
  674. </entry></row>
  675. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkHBox">GtkHBox</link> containing a <link linkend="GtkSpinButton">GtkSpinButton</link> for the random seed and
  676. a <link linkend="GtkToggleButton">GtkToggleButton</link> for toggling the <parameter>use_time</parameter> behaviour.
  677. </entry></row>
  678. </tbody></tgroup></informaltable></refsect2>
  679. <refsect2>
  680. <title><anchor id="GIMP-RANDOM-SEED-SPINBUTTON-CAPS">GIMP_RANDOM_SEED_SPINBUTTON()</title>
  681. <programlisting>#define     GIMP_RANDOM_SEED_SPINBUTTON(hbox)</programlisting>
  682. <para>
  683. Returns the random_seed's <link linkend="GtkSpinButton">GtkSpinButton</link>.
  684. </para><informaltable pgwide=1 frame="none" role="params">
  685. <tgroup cols="2">
  686. <colspec colwidth="2*">
  687. <colspec colwidth="8*">
  688. <tbody>
  689. <row><entry align="right"><parameter>hbox</parameter> :</entry>
  690. <entry>The <link linkend="GtkHBox">GtkHBox</link> returned by <link linkend="gimp-random-seed-new">gimp_random_seed_new</link>().
  691.  
  692.  
  693. </entry></row>
  694. </tbody></tgroup></informaltable></refsect2>
  695. <refsect2>
  696. <title><anchor id="GIMP-RANDOM-SEED-SPINBUTTON-ADJ-CAPS">GIMP_RANDOM_SEED_SPINBUTTON_ADJ()</title>
  697. <programlisting>#define     GIMP_RANDOM_SEED_SPINBUTTON_ADJ(hbox)</programlisting>
  698. <para>
  699. Returns the <link linkend="GtkAdjustment">GtkAdjustment</link> of the random_seed's <link linkend="GtkSpinButton">GtkSpinButton</link>.
  700. </para><informaltable pgwide=1 frame="none" role="params">
  701. <tgroup cols="2">
  702. <colspec colwidth="2*">
  703. <colspec colwidth="8*">
  704. <tbody>
  705. <row><entry align="right"><parameter>hbox</parameter> :</entry>
  706. <entry>The <link linkend="GtkHBox">GtkHBox</link> returned by <link linkend="gimp-random-seed-new">gimp_random_seed_new</link>().
  707.  
  708.  
  709. </entry></row>
  710. </tbody></tgroup></informaltable></refsect2>
  711. <refsect2>
  712. <title><anchor id="GIMP-RANDOM-SEED-TOGGLEBUTTON-CAPS">GIMP_RANDOM_SEED_TOGGLEBUTTON()</title>
  713. <programlisting>#define     GIMP_RANDOM_SEED_TOGGLEBUTTON(hbox)</programlisting>
  714. <para>
  715. Returns the random_seed's <link linkend="GtkToggleButton">GtkToggleButton</link>.
  716. </para><informaltable pgwide=1 frame="none" role="params">
  717. <tgroup cols="2">
  718. <colspec colwidth="2*">
  719. <colspec colwidth="8*">
  720. <tbody>
  721. <row><entry align="right"><parameter>hbox</parameter> :</entry>
  722. <entry>The <link linkend="GtkHBox">GtkHBox</link> returned by <link linkend="gimp-random-seed-new">gimp_random_seed_new</link>().
  723.  
  724.  
  725. </entry></row>
  726. </tbody></tgroup></informaltable></refsect2>
  727. <refsect2>
  728. <title><anchor id="gimp-coordinates-new">gimp_coordinates_new ()</title>
  729. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_coordinates_new            (<link linkend="GimpUnit">GimpUnit</link> unit,
  730.                                              const <link linkend="gchar">gchar</link> *unit_format,
  731.                                              <link linkend="gboolean">gboolean</link> menu_show_pixels,
  732.                                              <link linkend="gboolean">gboolean</link> menu_show_percent,
  733.                                              <link linkend="gint">gint</link> spinbutton_usize,
  734.                                              <link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy,
  735.                                              <link linkend="gboolean">gboolean</link> chainbutton_active,
  736.                                              <link linkend="gboolean">gboolean</link> chain_constrains_ratio,
  737.                                              const <link linkend="gchar">gchar</link> *xlabel,
  738.                                              <link linkend="gdouble">gdouble</link> x,
  739.                                              <link linkend="gdouble">gdouble</link> xres,
  740.                                              <link linkend="gdouble">gdouble</link> lower_boundary_x,
  741.                                              <link linkend="gdouble">gdouble</link> upper_boundary_x,
  742.                                              <link linkend="gdouble">gdouble</link> xsize_0,
  743.                                              <link linkend="gdouble">gdouble</link> xsize_100,
  744.                                              const <link linkend="gchar">gchar</link> *ylabel,
  745.                                              <link linkend="gdouble">gdouble</link> y,
  746.                                              <link linkend="gdouble">gdouble</link> yres,
  747.                                              <link linkend="gdouble">gdouble</link> lower_boundary_y,
  748.                                              <link linkend="gdouble">gdouble</link> upper_boundary_y,
  749.                                              <link linkend="gdouble">gdouble</link> ysize_0,
  750.                                              <link linkend="gdouble">gdouble</link> ysize_100);</programlisting>
  751. <para>
  752. </para>
  753. <para>
  754.  
  755. </para><informaltable pgwide=1 frame="none" role="params">
  756. <tgroup cols="2">
  757. <colspec colwidth="2*">
  758. <colspec colwidth="8*">
  759. <tbody>
  760. <row><entry align="right"><parameter>unit</parameter> :</entry>
  761. <entry>                   The initial unit of the <link linkend="GimpUnitMenu">GimpUnitMenu</link>.
  762. </entry></row>
  763. <row><entry align="right"><parameter>unit_format</parameter> :</entry>
  764. <entry>            The unit format string as passed to
  765. <link linkend="gimp-size-entry-new">gimp_size_entry_new</link>().
  766. </entry></row>
  767. <row><entry align="right"><parameter>menu_show_pixels</parameter> :</entry>
  768. <entry>       <link linkend="TRUE-CAPS">TRUE</link> if the <link linkend="GimpUnitMenu">GimpUnitMenu</link> should contain an item for
  769. GIMP_UNIT_PIXEL.
  770. </entry></row>
  771. <row><entry align="right"><parameter>menu_show_percent</parameter> :</entry>
  772. <entry>      <link linkend="TRUE-CAPS">TRUE</link> if the <link linkend="GimpUnitMenu">GimpUnitMenu</link> should contain an item for
  773. GIMP_UNIT_PERCENT.
  774. </entry></row>
  775. <row><entry align="right"><parameter>spinbutton_usize</parameter> :</entry>
  776. <entry>       The horizontal usize of the <link linkend="GimpSizeEntry">GimpSizeEntry</link>'s
  777. <link linkend="GtkSpinButton">GtkSpinButton</link>'s.
  778. </entry></row>
  779. <row><entry align="right"><parameter>update_policy</parameter> :</entry>
  780. <entry>          The update policy for the <link linkend="GimpSizeEntry">GimpSizeEntry</link>.
  781. </entry></row>
  782. <row><entry align="right"><parameter>chainbutton_active</parameter> :</entry>
  783. <entry>     <link linkend="TRUE-CAPS">TRUE</link> if the attached <link linkend="GimpChainButton">GimpChainButton</link> should be
  784. active.
  785. </entry></row>
  786. <row><entry align="right"><parameter>chain_constrains_ratio</parameter> :</entry>
  787. <entry> <link linkend="TRUE-CAPS">TRUE</link> if the chainbutton should constrain the
  788. fields' aspect ratio. If <link linkend="FALSE-CAPS">FALSE</link>, the values will
  789. be constrained.
  790. </entry></row>
  791. <row><entry align="right"><parameter>xlabel</parameter> :</entry>
  792. <entry>                 The label for the X coordinate.
  793. </entry></row>
  794. <row><entry align="right"><parameter>x</parameter> :</entry>
  795. <entry>                      The initial value of the X coordinate.
  796. </entry></row>
  797. <row><entry align="right"><parameter>xres</parameter> :</entry>
  798. <entry>                   The horizontal resolution in DPI.
  799. </entry></row>
  800. <row><entry align="right"><parameter>lower_boundary_x</parameter> :</entry>
  801. <entry>       The lower boundary of the X coordinate.
  802. </entry></row>
  803. <row><entry align="right"><parameter>upper_boundary_x</parameter> :</entry>
  804. <entry>       The upper boundary of the X coordinate.
  805. </entry></row>
  806. <row><entry align="right"><parameter>xsize_0</parameter> :</entry>
  807. <entry>                The X value which will be treated as 0%.
  808. </entry></row>
  809. <row><entry align="right"><parameter>xsize_100</parameter> :</entry>
  810. <entry>              The X value which will be treated as 100%.
  811. </entry></row>
  812. <row><entry align="right"><parameter>ylabel</parameter> :</entry>
  813. <entry>                 The label for the Y coordinate.
  814. </entry></row>
  815. <row><entry align="right"><parameter>y</parameter> :</entry>
  816. <entry>                      The initial value of the Y coordinate.
  817. </entry></row>
  818. <row><entry align="right"><parameter>yres</parameter> :</entry>
  819. <entry>                   The vertical resolution in DPI.
  820. </entry></row>
  821. <row><entry align="right"><parameter>lower_boundary_y</parameter> :</entry>
  822. <entry>       The lower boundary of the Y coordinate.
  823. </entry></row>
  824. <row><entry align="right"><parameter>upper_boundary_y</parameter> :</entry>
  825. <entry>       The upper boundary of the Y coordinate.
  826. </entry></row>
  827. <row><entry align="right"><parameter>ysize_0</parameter> :</entry>
  828. <entry>                The Y value which will be treated as 0%.
  829. </entry></row>
  830. <row><entry align="right"><parameter>ysize_100</parameter> :</entry>
  831. <entry>              The Y value which will be treated as 100%.
  832. </entry></row>
  833. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GimpSizeEntry">GimpSizeEntry</link> with two fields for x/y coordinates/sizes with
  834. a <link linkend="GimpChainButton">GimpChainButton</link> attached to constrain either the two fields'
  835. values or the ratio between them.
  836. </entry></row>
  837. </tbody></tgroup></informaltable></refsect2>
  838. <refsect2>
  839. <title><anchor id="GIMP-COORDINATES-CHAINBUTTON-CAPS">GIMP_COORDINATES_CHAINBUTTON()</title>
  840. <programlisting>#define     GIMP_COORDINATES_CHAINBUTTON(sizeentry)</programlisting>
  841. <para>
  842. Returns the <link linkend="GimpChainButton">GimpChainButton</link> which is attached to the <link linkend="GimpSizeEntry">GimpSizeEntry</link>.
  843. </para><informaltable pgwide=1 frame="none" role="params">
  844. <tgroup cols="2">
  845. <colspec colwidth="2*">
  846. <colspec colwidth="8*">
  847. <tbody>
  848. <row><entry align="right"><parameter>sizeentry</parameter> :</entry>
  849. <entry>The <link linkend="GimpSizeEntry">GimpSizeEntry</link> returned by <link linkend="gimp-coordinates-new">gimp_coordinates_new</link>().
  850.  
  851.  
  852. </entry></row>
  853. </tbody></tgroup></informaltable></refsect2>
  854. <refsect2>
  855. <title><anchor id="gimp-mem-size-entry-new">gimp_mem_size_entry_new ()</title>
  856. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_mem_size_entry_new         (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);</programlisting>
  857. <para>
  858. </para>
  859. <para>
  860.  
  861. </para><informaltable pgwide=1 frame="none" role="params">
  862. <tgroup cols="2">
  863. <colspec colwidth="2*">
  864. <colspec colwidth="8*">
  865. <tbody>
  866. <row><entry align="right"><parameter>adjustment</parameter> :</entry>
  867. <entry> The adjustment containing the memsize and it's limits.
  868. </entry></row>
  869. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkHBox">GtkHBox</link> with a <link linkend="GtkSpinButton">GtkSpinButton</link> and a <link linkend="GtkOptionMenu">GtkOptionMenu</link>.
  870. </entry></row>
  871. </tbody></tgroup></informaltable></refsect2>
  872. <refsect2>
  873. <title><anchor id="GIMP-MEM-SIZE-ENTRY-SPINBUTTON-CAPS">GIMP_MEM_SIZE_ENTRY_SPINBUTTON()</title>
  874. <programlisting>#define     GIMP_MEM_SIZE_ENTRY_SPINBUTTON(memsize)</programlisting>
  875. <para>
  876.  
  877. </para><informaltable pgwide=1 frame="none" role="params">
  878. <tgroup cols="2">
  879. <colspec colwidth="2*">
  880. <colspec colwidth="8*">
  881. <tbody>
  882. <row><entry align="right"><parameter>memsize</parameter> :</entry>
  883. <entry>
  884.  
  885. </entry></row>
  886. </tbody></tgroup></informaltable></refsect2>
  887. <refsect2>
  888. <title><anchor id="GIMP-MEM-SIZE-ENTRY-SPINBUTTON-ADJ-CAPS">GIMP_MEM_SIZE_ENTRY_SPINBUTTON_ADJ()</title>
  889. <programlisting>#define     GIMP_MEM_SIZE_ENTRY_SPINBUTTON_ADJ(memsize)</programlisting>
  890. <para>
  891.  
  892. </para><informaltable pgwide=1 frame="none" role="params">
  893. <tgroup cols="2">
  894. <colspec colwidth="2*">
  895. <colspec colwidth="8*">
  896. <tbody>
  897. <row><entry align="right"><parameter>memsize</parameter> :</entry>
  898. <entry>
  899.  
  900. </entry></row>
  901. </tbody></tgroup></informaltable></refsect2>
  902. <refsect2>
  903. <title><anchor id="GIMP-MEM-SIZE-ENTRY-OPTIONMENU-CAPS">GIMP_MEM_SIZE_ENTRY_OPTIONMENU()</title>
  904. <programlisting>#define     GIMP_MEM_SIZE_ENTRY_OPTIONMENU(memsize)</programlisting>
  905. <para>
  906.  
  907. </para><informaltable pgwide=1 frame="none" role="params">
  908. <tgroup cols="2">
  909. <colspec colwidth="2*">
  910. <colspec colwidth="8*">
  911. <tbody>
  912. <row><entry align="right"><parameter>memsize</parameter> :</entry>
  913. <entry>
  914.  
  915. </entry></row>
  916. </tbody></tgroup></informaltable></refsect2>
  917. <refsect2>
  918. <title><anchor id="gimp-pixmap-button-new">gimp_pixmap_button_new ()</title>
  919. <programlisting><link linkend="GtkWidget">GtkWidget</link>*  gimp_pixmap_button_new          (<link linkend="gchar">gchar</link> **xpm_data,
  920.                                              const <link linkend="gchar">gchar</link> *text);</programlisting>
  921. <para>
  922. </para>
  923. <para>
  924.  
  925. </para><informaltable pgwide=1 frame="none" role="params">
  926. <tgroup cols="2">
  927. <colspec colwidth="2*">
  928. <colspec colwidth="8*">
  929. <tbody>
  930. <row><entry align="right"><parameter>xpm_data</parameter> :</entry>
  931. <entry> The XPM data which will be passed to <link linkend="gimp-pixmap-new">gimp_pixmap_new</link>().
  932. </entry></row>
  933. <row><entry align="right"><parameter>text</parameter> :</entry>
  934. <entry>     An optional text which will appear right of the pixmap.
  935. </entry></row>
  936. <row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A <link linkend="GtkButton">GtkButton</link> with a <link linkend="GimpPixmap">GimpPixmap</link> and an optional <link linkend="GtkLabel">GtkLabel</link>.
  937. </entry></row>
  938. </tbody></tgroup></informaltable></refsect2>
  939. <refsect2>
  940. <title><anchor id="gimp-toggle-button-sensitive-update">gimp_toggle_button_sensitive_update ()</title>
  941. <programlisting>void        gimp_toggle_button_sensitive_update
  942.                                             (<link linkend="GtkToggleButton">GtkToggleButton</link> *toggle_button);</programlisting>
  943. <para>
  944. If you attached a pointer to a <link linkend="GtkWidget">GtkWidget</link> with <link linkend="gtk-object-set-data">gtk_object_set_data</link>() and
  945. the "set_sensitive" key to the <link linkend="GtkToggleButton">GtkToggleButton</link>, the sensitive state of
  946. the attached widget will be set according to the toggle button's
  947. "active" state.
  948. </para>
  949. <para>
  950. You can attach an arbitrary list of widgets by attaching another
  951. "set_sensitive" data pointer to the first widget (and so on...).
  952. </para>
  953. <para>
  954. This function can also set the sensitive state according to the toggle
  955. button's inverse "active" state by attaching widgets with the
  956. "inverse_sensitive" key.</para>
  957. <para>
  958.  
  959. </para><informaltable pgwide=1 frame="none" role="params">
  960. <tgroup cols="2">
  961. <colspec colwidth="2*">
  962. <colspec colwidth="8*">
  963. <tbody>
  964. <row><entry align="right"><parameter>toggle_button</parameter> :</entry>
  965. <entry> The <link linkend="GtkToggleButton">GtkToggleButton</link> the "set_sensitive" and
  966. "inverse_sensitive" lists are attached to.
  967. </entry></row>
  968. </tbody></tgroup></informaltable></refsect2>
  969. <refsect2>
  970. <title><anchor id="gimp-toggle-button-update">gimp_toggle_button_update ()</title>
  971. <programlisting>void        gimp_toggle_button_update       (<link linkend="GtkWidget">GtkWidget</link> *widget,
  972.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  973. <para>
  974. Note that this function calls <link linkend="gimp-toggle-button-sensitive-update">gimp_toggle_button_sensitive_update</link>().</para>
  975. <para>
  976.  
  977. </para><informaltable pgwide=1 frame="none" role="params">
  978. <tgroup cols="2">
  979. <colspec colwidth="2*">
  980. <colspec colwidth="8*">
  981. <tbody>
  982. <row><entry align="right"><parameter>widget</parameter> :</entry>
  983. <entry> A <link linkend="GtkToggleButton">GtkToggleButton</link>.
  984. </entry></row>
  985. <row><entry align="right"><parameter>data</parameter> :</entry>
  986. <entry>   A pointer to a <link linkend="gint">gint</link> variable which will store the value of
  987. <link linkend="gtk-toggle-button-get-active">gtk_toggle_button_get_active</link>().
  988. </entry></row>
  989. </tbody></tgroup></informaltable></refsect2>
  990. <refsect2>
  991. <title><anchor id="gimp-radio-button-update">gimp_radio_button_update ()</title>
  992. <programlisting>void        gimp_radio_button_update        (<link linkend="GtkWidget">GtkWidget</link> *widget,
  993.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  994. <para>
  995. Note that this function calls <link linkend="gimp-toggle-button-sensitive-update">gimp_toggle_button_sensitive_update</link>().</para>
  996. <para>
  997.  
  998. </para><informaltable pgwide=1 frame="none" role="params">
  999. <tgroup cols="2">
  1000. <colspec colwidth="2*">
  1001. <colspec colwidth="8*">
  1002. <tbody>
  1003. <row><entry align="right"><parameter>widget</parameter> :</entry>
  1004. <entry> A <link linkend="GtkRadioButton">GtkRadioButton</link>.
  1005. </entry></row>
  1006. <row><entry align="right"><parameter>data</parameter> :</entry>
  1007. <entry>   A pointer to a <link linkend="gint">gint</link> variable which will store the value of
  1008. GPOINTER_TO_INT (<link linkend="gtk-object-get-user-data">gtk_object_get_user_data</link>()).
  1009. </entry></row>
  1010. </tbody></tgroup></informaltable></refsect2>
  1011. <refsect2>
  1012. <title><anchor id="gimp-menu-item-update">gimp_menu_item_update ()</title>
  1013. <programlisting>void        gimp_menu_item_update           (<link linkend="GtkWidget">GtkWidget</link> *widget,
  1014.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  1015. <para>
  1016. </para>
  1017. <para>
  1018.  
  1019. </para><informaltable pgwide=1 frame="none" role="params">
  1020. <tgroup cols="2">
  1021. <colspec colwidth="2*">
  1022. <colspec colwidth="8*">
  1023. <tbody>
  1024. <row><entry align="right"><parameter>widget</parameter> :</entry>
  1025. <entry> A <link linkend="GtkMenuItem">GtkMenuItem</link>.
  1026. </entry></row>
  1027. <row><entry align="right"><parameter>data</parameter> :</entry>
  1028. <entry>   A pointer to a <link linkend="gint">gint</link> variable which will store the value of
  1029. GPOINTER_TO_INT (<link linkend="gtk-object-get-user-data">gtk_object_get_user_data</link>()).
  1030. </entry></row>
  1031. </tbody></tgroup></informaltable></refsect2>
  1032. <refsect2>
  1033. <title><anchor id="gimp-int-adjustment-update">gimp_int_adjustment_update ()</title>
  1034. <programlisting>void        gimp_int_adjustment_update      (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  1035.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  1036. <para>
  1037. Note that the <link linkend="GtkAdjustment">GtkAdjustment</link>'s value (which is a <link linkend="gfloat">gfloat</link>) will be rounded
  1038. with <link linkend="RINT-CAPS">RINT</link>().</para>
  1039. <para>
  1040.  
  1041. </para><informaltable pgwide=1 frame="none" role="params">
  1042. <tgroup cols="2">
  1043. <colspec colwidth="2*">
  1044. <colspec colwidth="8*">
  1045. <tbody>
  1046. <row><entry align="right"><parameter>adjustment</parameter> :</entry>
  1047. <entry> A <link linkend="GtkAdjustment">GtkAdjustment</link>.
  1048. </entry></row>
  1049. <row><entry align="right"><parameter>data</parameter> :</entry>
  1050. <entry>       A pointer to a <link linkend="gint">gint</link> variable which will store the
  1051. <parameter>adjustment</parameter>'s value.
  1052. </entry></row>
  1053. </tbody></tgroup></informaltable></refsect2>
  1054. <refsect2>
  1055. <title><anchor id="gimp-uint-adjustment-update">gimp_uint_adjustment_update ()</title>
  1056. <programlisting>void        gimp_uint_adjustment_update     (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  1057.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  1058. <para>
  1059. Note that the <link linkend="GtkAdjustment">GtkAdjustment</link>'s value (which is a <link linkend="gfloat">gfloat</link>) will be rounded
  1060. with (<link linkend="guint">guint</link>) (value + 0.5).</para>
  1061. <para>
  1062.  
  1063. </para><informaltable pgwide=1 frame="none" role="params">
  1064. <tgroup cols="2">
  1065. <colspec colwidth="2*">
  1066. <colspec colwidth="8*">
  1067. <tbody>
  1068. <row><entry align="right"><parameter>adjustment</parameter> :</entry>
  1069. <entry> A <link linkend="GtkAdjustment">GtkAdjustment</link>.
  1070. </entry></row>
  1071. <row><entry align="right"><parameter>data</parameter> :</entry>
  1072. <entry>       A pointer to a <link linkend="guint">guint</link> variable which will store the
  1073. <parameter>adjustment</parameter>'s value.
  1074. </entry></row>
  1075. </tbody></tgroup></informaltable></refsect2>
  1076. <refsect2>
  1077. <title><anchor id="gimp-float-adjustment-update">gimp_float_adjustment_update ()</title>
  1078. <programlisting>void        gimp_float_adjustment_update    (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  1079.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  1080. <para>
  1081. </para>
  1082. <para>
  1083.  
  1084. </para><informaltable pgwide=1 frame="none" role="params">
  1085. <tgroup cols="2">
  1086. <colspec colwidth="2*">
  1087. <colspec colwidth="8*">
  1088. <tbody>
  1089. <row><entry align="right"><parameter>adjustment</parameter> :</entry>
  1090. <entry> A <link linkend="GtkAdjustment">GtkAdjustment</link>.
  1091. </entry></row>
  1092. <row><entry align="right"><parameter>data</parameter> :</entry>
  1093. <entry>       A pointer to a <link linkend="gfloat">gfloat</link> varaiable which willl store the
  1094. <parameter>adjustment</parameter>'s value.
  1095. </entry></row>
  1096. </tbody></tgroup></informaltable></refsect2>
  1097. <refsect2>
  1098. <title><anchor id="gimp-double-adjustment-update">gimp_double_adjustment_update ()</title>
  1099. <programlisting>void        gimp_double_adjustment_update   (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment,
  1100.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  1101. <para>
  1102. </para>
  1103. <para>
  1104.  
  1105. </para><informaltable pgwide=1 frame="none" role="params">
  1106. <tgroup cols="2">
  1107. <colspec colwidth="2*">
  1108. <colspec colwidth="8*">
  1109. <tbody>
  1110. <row><entry align="right"><parameter>adjustment</parameter> :</entry>
  1111. <entry> A <link linkend="GtkAdjustment">GtkAdjustment</link>.
  1112. </entry></row>
  1113. <row><entry align="right"><parameter>data</parameter> :</entry>
  1114. <entry>       A pointer to a <link linkend="gdouble">gdouble</link> variable which will store the
  1115. <parameter>adjustment</parameter>'s value.
  1116. </entry></row>
  1117. </tbody></tgroup></informaltable></refsect2>
  1118. <refsect2>
  1119. <title><anchor id="gimp-unit-menu-update">gimp_unit_menu_update ()</title>
  1120. <programlisting>void        gimp_unit_menu_update           (<link linkend="GtkWidget">GtkWidget</link> *widget,
  1121.                                              <link linkend="gpointer">gpointer</link> data);</programlisting>
  1122. <para>
  1123. This callback can set the number of decimal digits of an arbitrary number
  1124. of <link linkend="GtkSpinButton">GtkSpinButton</link>'s. To use this functionality, attach the spinbuttons
  1125. as list of data pointers attached with <link linkend="gtk-object-set-data">gtk_object_set_data</link>() with the
  1126. "set_digits" key.
  1127. </para>
  1128. <para>
  1129. See <link linkend="gimp-toggle-button-sensitive-update">gimp_toggle_button_sensitive_update</link>() for a description of how
  1130. to set up the list.</para>
  1131. <para>
  1132.  
  1133. </para><informaltable pgwide=1 frame="none" role="params">
  1134. <tgroup cols="2">
  1135. <colspec colwidth="2*">
  1136. <colspec colwidth="8*">
  1137. <tbody>
  1138. <row><entry align="right"><parameter>widget</parameter> :</entry>
  1139. <entry> A <link linkend="GimpUnitMenu">GimpUnitMenu</link>.
  1140. </entry></row>
  1141. <row><entry align="right"><parameter>data</parameter> :</entry>
  1142. <entry>   A pointer to a <link linkend="GimpUnit">GimpUnit</link> variable which will store the unit menu's
  1143. value.
  1144. </entry></row>
  1145. </tbody></tgroup></informaltable></refsect2>
  1146. <refsect2>
  1147. <title><anchor id="gimp-table-attach-aligned">gimp_table_attach_aligned ()</title>
  1148. <programlisting>void        gimp_table_attach_aligned       (<link linkend="GtkTable">GtkTable</link> *table,
  1149.                                              <link linkend="gint">gint</link> column,
  1150.                                              <link linkend="gint">gint</link> row,
  1151.                                              const <link linkend="gchar">gchar</link> *label_text,
  1152.                                              <link linkend="gfloat">gfloat</link> xalign,
  1153.                                              <link linkend="gfloat">gfloat</link> yalign,
  1154.                                              <link linkend="GtkWidget">GtkWidget</link> *widget,
  1155.                                              <link linkend="gint">gint</link> colspan,
  1156.                                              <link linkend="gboolean">gboolean</link> left_align);</programlisting>
  1157. <para>
  1158. Note that the <parameter>label_text</parameter> can be <link linkend="NULL-CAPS">NULL</link> and that the widget will be attached
  1159. starting at (<parameter>column</parameter> + 1) in this case, too.</para>
  1160. <para>
  1161.  
  1162. </para><informaltable pgwide=1 frame="none" role="params">
  1163. <tgroup cols="2">
  1164. <colspec colwidth="2*">
  1165. <colspec colwidth="8*">
  1166. <tbody>
  1167. <row><entry align="right"><parameter>table</parameter> :</entry>
  1168. <entry>      The <link linkend="GtkTable">GtkTable</link> the widgets will be attached to.
  1169. </entry></row>
  1170. <row><entry align="right"><parameter>column</parameter> :</entry>
  1171. <entry>     The column to start with.
  1172. </entry></row>
  1173. <row><entry align="right"><parameter>row</parameter> :</entry>
  1174. <entry>        The row to attach the eidgets.
  1175. </entry></row>
  1176. <row><entry align="right"><parameter>label_text</parameter> :</entry>
  1177. <entry> The text for the <link linkend="GtkLabel">GtkLabel</link> which will be attached left of the
  1178. widget.
  1179. </entry></row>
  1180. <row><entry align="right"><parameter>xalign</parameter> :</entry>
  1181. <entry>     The horizontal alignment of the <link linkend="GtkLabel">GtkLabel</link>.
  1182. </entry></row>
  1183. <row><entry align="right"><parameter>yalign</parameter> :</entry>
  1184. <entry>     The vertival alignment of the <link linkend="GtkLabel">GtkLabel</link>.
  1185. </entry></row>
  1186. <row><entry align="right"><parameter>widget</parameter> :</entry>
  1187. <entry>     The <link linkend="GtkWidget">GtkWidget</link> to attach right of the label.
  1188. </entry></row>
  1189. <row><entry align="right"><parameter>colspan</parameter> :</entry>
  1190. <entry>    The number of columns the widget will use.
  1191. </entry></row>
  1192. <row><entry align="right"><parameter>left_align</parameter> :</entry>
  1193. <entry> <link linkend="TRUE-CAPS">TRUE</link> if the widget should be left-aligned.
  1194. </entry></row>
  1195. </tbody></tgroup></informaltable></refsect2>
  1196.  
  1197. </refsect1>
  1198.  
  1199.  
  1200.  
  1201.  
  1202. </refentry>
  1203.